home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Environments / Prograph Classic 2.6.1 / Examples / Progress Window / Progress Window.ReadMe < prev   
Text File  |  1995-09-28  |  2KB  |  35 lines
  1. Example:                       Progress Window
  2. Written by:                   Garth Smedley, Pictorius Incorporated
  3.                                      Lynn McKaig, TGS Systems
  4.                                      Tim Snyder, TGS Systems
  5. Updated for 2.6.1 by:            The Tech Support Team, Pictorius Incorporated
  6.  
  7.  
  8. Contents:      Progress Window.pgs
  9.                     Progress Window ReadMe
  10.  
  11. New Classes
  12.                                         Progress Window
  13.                                         Progress Bar
  14.                                         Spinning Cursor
  15.  
  16. Needs Prograph Extensions:
  17.                     The default configuration of your 'Prograph Extensions' folder.
  18.  
  19. Needs Libraries to Compile:
  20.                    SCLibrary 2.6
  21.                    Library 2.6
  22.  
  23. Description
  24. -----------
  25. This example shows how to implement a progress window with a stop button, a progress bar and a spinning watch cursor. The example window is much like the progress window used by the System 7 Finder for file copying.
  26.  
  27. How to Use in Your Program
  28. -------------------------
  29. First, you will need to load the three classes listed under "New Classes" into your file.  You will also need to use ResEdit to copy the cursor resources from "Progress Window.pgs" into your file. The spinning watch cursor resources have type 'CURS', id's 256 through 263.
  30.     
  31. When your application is about to begin a lengthy operation, create an instance of "Progress Window" and call the "Open Progress" method to open the window, then while the operation is being performed, call "Handle Event" fairly often to give the user a chance to press the stop button. Call "Advance Progress" to update the progress bar. You may also want to call "Change Message" to change the text of the progress window, if your operation has several distinct parts.
  32.  
  33. "Handle Event" checks for events and also spins the watch cursor. It is based on the "Modal Window" example on the 2.5 distribution disks.  "Mouse Down" changes the cursor to an arrow when the user clicks in the button or in the drag area. "Close" changes the cursor back to an arrow before the progress window is closed.
  34.  
  35.